home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / Kubuntu 8.10 / kubuntu-8.10-desktop-i386.iso / casper / filesystem.squashfs / usr / lib / python2.5 / base64.pyc (.txt) < prev    next >
Python Compiled Bytecode  |  2008-10-29  |  11KB  |  379 lines

  1. # Source Generated with Decompyle++
  2. # File: in.pyc (Python 2.5)
  3.  
  4. '''RFC 3548: Base16, Base32, Base64 Data Encodings'''
  5. import re
  6. import struct
  7. import binascii
  8. __all__ = [
  9.     'encode',
  10.     'decode',
  11.     'encodestring',
  12.     'decodestring',
  13.     'b64encode',
  14.     'b64decode',
  15.     'b32encode',
  16.     'b32decode',
  17.     'b16encode',
  18.     'b16decode',
  19.     'standard_b64encode',
  20.     'standard_b64decode',
  21.     'urlsafe_b64encode',
  22.     'urlsafe_b64decode']
  23. _translation = [ chr(_x) for _x in range(256) ]
  24. EMPTYSTRING = ''
  25.  
  26. def _translate(s, altchars):
  27.     translation = _translation[:]
  28.     for k, v in altchars.items():
  29.         translation[ord(k)] = v
  30.     
  31.     return s.translate(''.join(translation))
  32.  
  33.  
  34. def b64encode(s, altchars = None):
  35.     """Encode a string using Base64.
  36.  
  37.     s is the string to encode.  Optional altchars must be a string of at least
  38.     length 2 (additional characters are ignored) which specifies an
  39.     alternative alphabet for the '+' and '/' characters.  This allows an
  40.     application to e.g. generate url or filesystem safe Base64 strings.
  41.  
  42.     The encoded string is returned.
  43.     """
  44.     encoded = binascii.b2a_base64(s)[:-1]
  45.     if altchars is not None:
  46.         return _translate(encoded, {
  47.             '+': altchars[0],
  48.             '/': altchars[1] })
  49.     
  50.     return encoded
  51.  
  52.  
  53. def b64decode(s, altchars = None):
  54.     """Decode a Base64 encoded string.
  55.  
  56.     s is the string to decode.  Optional altchars must be a string of at least
  57.     length 2 (additional characters are ignored) which specifies the
  58.     alternative alphabet used instead of the '+' and '/' characters.
  59.  
  60.     The decoded string is returned.  A TypeError is raised if s were
  61.     incorrectly padded or if there are non-alphabet characters present in the
  62.     string.
  63.     """
  64.     if altchars is not None:
  65.         s = _translate(s, {
  66.             altchars[0]: '+',
  67.             altchars[1]: '/' })
  68.     
  69.     
  70.     try:
  71.         return binascii.a2b_base64(s)
  72.     except binascii.Error:
  73.         msg = None
  74.         raise TypeError(msg)
  75.  
  76.  
  77.  
  78. def standard_b64encode(s):
  79.     '''Encode a string using the standard Base64 alphabet.
  80.  
  81.     s is the string to encode.  The encoded string is returned.
  82.     '''
  83.     return b64encode(s)
  84.  
  85.  
  86. def standard_b64decode(s):
  87.     '''Decode a string encoded with the standard Base64 alphabet.
  88.  
  89.     s is the string to decode.  The decoded string is returned.  A TypeError
  90.     is raised if the string is incorrectly padded or if there are non-alphabet
  91.     characters present in the string.
  92.     '''
  93.     return b64decode(s)
  94.  
  95.  
  96. def urlsafe_b64encode(s):
  97.     """Encode a string using a url-safe Base64 alphabet.
  98.  
  99.     s is the string to encode.  The encoded string is returned.  The alphabet
  100.     uses '-' instead of '+' and '_' instead of '/'.
  101.     """
  102.     return b64encode(s, '-_')
  103.  
  104.  
  105. def urlsafe_b64decode(s):
  106.     """Decode a string encoded with the standard Base64 alphabet.
  107.  
  108.     s is the string to decode.  The decoded string is returned.  A TypeError
  109.     is raised if the string is incorrectly padded or if there are non-alphabet
  110.     characters present in the string.
  111.  
  112.     The alphabet uses '-' instead of '+' and '_' instead of '/'.
  113.     """
  114.     return b64decode(s, '-_')
  115.  
  116. _b32alphabet = {
  117.     0: 'A',
  118.     9: 'J',
  119.     18: 'S',
  120.     27: '3',
  121.     1: 'B',
  122.     10: 'K',
  123.     19: 'T',
  124.     28: '4',
  125.     2: 'C',
  126.     11: 'L',
  127.     20: 'U',
  128.     29: '5',
  129.     3: 'D',
  130.     12: 'M',
  131.     21: 'V',
  132.     30: '6',
  133.     4: 'E',
  134.     13: 'N',
  135.     22: 'W',
  136.     31: '7',
  137.     5: 'F',
  138.     14: 'O',
  139.     23: 'X',
  140.     6: 'G',
  141.     15: 'P',
  142.     24: 'Y',
  143.     7: 'H',
  144.     16: 'Q',
  145.     25: 'Z',
  146.     8: 'I',
  147.     17: 'R',
  148.     26: '2' }
  149. _b32tab = _b32alphabet.items()
  150. _b32tab.sort()
  151. _b32tab = [ v for k, v in _b32tab ]
  152. _b32rev = []([ (v, long(k)) for k, v in _b32alphabet.items() ])
  153.  
  154. def b32encode(s):
  155.     '''Encode a string using Base32.
  156.  
  157.     s is the string to encode.  The encoded string is returned.
  158.     '''
  159.     parts = []
  160.     (quanta, leftover) = divmod(len(s), 5)
  161.     if leftover:
  162.         s += '\x00' * (5 - leftover)
  163.         quanta += 1
  164.     
  165.     for i in range(quanta):
  166.         (c1, c2, c3) = struct.unpack('!HHB', s[i * 5:(i + 1) * 5])
  167.         c2 += (c1 & 1) << 16
  168.         c3 += (c2 & 3) << 8
  169.         parts.extend([
  170.             _b32tab[c1 >> 11],
  171.             _b32tab[c1 >> 6 & 31],
  172.             _b32tab[c1 >> 1 & 31],
  173.             _b32tab[c2 >> 12],
  174.             _b32tab[c2 >> 7 & 31],
  175.             _b32tab[c2 >> 2 & 31],
  176.             _b32tab[c3 >> 5],
  177.             _b32tab[c3 & 31]])
  178.     
  179.     encoded = EMPTYSTRING.join(parts)
  180.     if leftover == 1:
  181.         return encoded[:-6] + '======'
  182.     elif leftover == 2:
  183.         return encoded[:-4] + '===='
  184.     elif leftover == 3:
  185.         return encoded[:-3] + '==='
  186.     elif leftover == 4:
  187.         return encoded[:-1] + '='
  188.     
  189.     return encoded
  190.  
  191.  
  192. def b32decode(s, casefold = False, map01 = None):
  193.     '''Decode a Base32 encoded string.
  194.  
  195.     s is the string to decode.  Optional casefold is a flag specifying whether
  196.     a lowercase alphabet is acceptable as input.  For security purposes, the
  197.     default is False.
  198.  
  199.     RFC 3548 allows for optional mapping of the digit 0 (zero) to the letter O
  200.     (oh), and for optional mapping of the digit 1 (one) to either the letter I
  201.     (eye) or letter L (el).  The optional argument map01 when not None,
  202.     specifies which letter the digit 1 should be mapped to (when map01 is not
  203.     None, the digit 0 is always mapped to the letter O).  For security
  204.     purposes the default is None, so that 0 and 1 are not allowed in the
  205.     input.
  206.  
  207.     The decoded string is returned.  A TypeError is raised if s were
  208.     incorrectly padded or if there are non-alphabet characters present in the
  209.     string.
  210.     '''
  211.     (quanta, leftover) = divmod(len(s), 8)
  212.     if leftover:
  213.         raise TypeError('Incorrect padding')
  214.     
  215.     if map01:
  216.         s = _translate(s, {
  217.             '0': 'O',
  218.             '1': map01 })
  219.     
  220.     if casefold:
  221.         s = s.upper()
  222.     
  223.     padchars = 0
  224.     mo = re.search('(?P<pad>[=]*)$', s)
  225.     if mo:
  226.         padchars = len(mo.group('pad'))
  227.         if padchars > 0:
  228.             s = s[:-padchars]
  229.         
  230.     
  231.     parts = []
  232.     acc = 0
  233.     shift = 35
  234.     for c in s:
  235.         val = _b32rev.get(c)
  236.         if val is None:
  237.             raise TypeError('Non-base32 digit found')
  238.         
  239.         acc += _b32rev[c] << shift
  240.         shift -= 5
  241.         if shift < 0:
  242.             parts.append(binascii.unhexlify('%010x' % acc))
  243.             acc = 0
  244.             shift = 35
  245.             continue
  246.     
  247.     last = binascii.unhexlify('%010x' % acc)
  248.     if padchars == 0:
  249.         last = ''
  250.     elif padchars == 1:
  251.         last = last[:-1]
  252.     elif padchars == 3:
  253.         last = last[:-2]
  254.     elif padchars == 4:
  255.         last = last[:-3]
  256.     elif padchars == 6:
  257.         last = last[:-4]
  258.     else:
  259.         raise TypeError('Incorrect padding')
  260.     parts.append(last)
  261.     return EMPTYSTRING.join(parts)
  262.  
  263.  
  264. def b16encode(s):
  265.     '''Encode a string using Base16.
  266.  
  267.     s is the string to encode.  The encoded string is returned.
  268.     '''
  269.     return binascii.hexlify(s).upper()
  270.  
  271.  
  272. def b16decode(s, casefold = False):
  273.     '''Decode a Base16 encoded string.
  274.  
  275.     s is the string to decode.  Optional casefold is a flag specifying whether
  276.     a lowercase alphabet is acceptable as input.  For security purposes, the
  277.     default is False.
  278.  
  279.     The decoded string is returned.  A TypeError is raised if s were
  280.     incorrectly padded or if there are non-alphabet characters present in the
  281.     string.
  282.     '''
  283.     if casefold:
  284.         s = s.upper()
  285.     
  286.     if re.search('[^0-9A-F]', s):
  287.         raise TypeError('Non-base16 digit found')
  288.     
  289.     return binascii.unhexlify(s)
  290.  
  291. MAXLINESIZE = 76
  292. MAXBINSIZE = (MAXLINESIZE // 4) * 3
  293.  
  294. def encode(input, output):
  295.     '''Encode a file.'''
  296.     while True:
  297.         s = input.read(MAXBINSIZE)
  298.         if not s:
  299.             break
  300.         
  301.         while len(s) < MAXBINSIZE:
  302.             ns = input.read(MAXBINSIZE - len(s))
  303.             if not ns:
  304.                 break
  305.             
  306.             s += ns
  307.         line = binascii.b2a_base64(s)
  308.         output.write(line)
  309.  
  310.  
  311. def decode(input, output):
  312.     '''Decode a file.'''
  313.     while True:
  314.         line = input.readline()
  315.         if not line:
  316.             break
  317.         
  318.         s = binascii.a2b_base64(line)
  319.         output.write(s)
  320.  
  321.  
  322. def encodestring(s):
  323.     '''Encode a string.'''
  324.     pieces = []
  325.     for i in range(0, len(s), MAXBINSIZE):
  326.         chunk = s[i:i + MAXBINSIZE]
  327.         pieces.append(binascii.b2a_base64(chunk))
  328.     
  329.     return ''.join(pieces)
  330.  
  331.  
  332. def decodestring(s):
  333.     '''Decode a string.'''
  334.     return binascii.a2b_base64(s)
  335.  
  336.  
  337. def test():
  338.     '''Small test program'''
  339.     import sys as sys
  340.     import getopt as getopt
  341.     
  342.     try:
  343.         (opts, args) = getopt.getopt(sys.argv[1:], 'deut')
  344.     except getopt.error:
  345.         msg = None
  346.         sys.stdout = sys.stderr
  347.         print msg
  348.         print "usage: %s [-d|-e|-u|-t] [file|-]\n        -d, -u: decode\n        -e: encode (default)\n        -t: encode and decode string 'Aladdin:open sesame'" % sys.argv[0]
  349.         sys.exit(2)
  350.  
  351.     func = encode
  352.     for o, a in opts:
  353.         if o == '-e':
  354.             func = encode
  355.         
  356.         if o == '-d':
  357.             func = decode
  358.         
  359.         if o == '-u':
  360.             func = decode
  361.         
  362.         if o == '-t':
  363.             test1()
  364.             return None
  365.             continue
  366.     
  367.     if args and args[0] != '-':
  368.         func(open(args[0], 'rb'), sys.stdout)
  369.     else:
  370.         func(sys.stdin, sys.stdout)
  371.  
  372.  
  373. def test1():
  374.     s0 = 'Aladdin:open sesame'
  375.     s1 = encodestring(s0)
  376.     s2 = decodestring(s1)
  377.     print s0, repr(s1), s2
  378.  
  379.